home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / sys / c / reqask.dok < prev    next >
Encoding:
Text File  |  1993-02-02  |  11.7 KB  |  323 lines
  1.  
  2.                                                        Wuerzburg, 03-Feb-93
  3.  
  4.                                 ReqASK 1.0
  5.  
  6.                           Deutsche Dokumentation
  7.  
  8.  
  9. Rechtliches
  10. ~~~~~~~~~~~
  11.  
  12.   ReqASK  und  alle  zugehoerigen Dateien unterliegen dem Urheberrecht 1993
  13. bei  Marc  Heuler.   Dieses Programm ist Shareware.  Wenn Sie es moegen und
  14. oft benutzen, zahlen Sie bitte die Shareware-Gebuehr von 10.- DM.
  15.  
  16.   Sie duerfen ReqASK unter folgenden Bedingungen verbreiten:
  17.  
  18.         · Verlangen Sie *nichts* fuer das kopieren, ausgenommen die Kosten
  19.           fuer das Medium (z.B. Diskette) selbst.
  20.  
  21.         · Aendern Sie keine der diesem Programm zugehoerigen Dateien
  22.  
  23.         · Verbreiten Sie alle Dateien *zusammen*, also zusammengepackt in
  24.           einem Archiv
  25.  
  26.         · Deutsche PD-Serien duerfen dieses Programm nicht vertreiben
  27.  
  28.         · Fred Fish mit seiner welt-bekannten Software Bibliothek muss sich
  29.           um keine der genannten Bedingungen kuemmern.
  30.  
  31.   Dieses Programm ist, wie man so schoen sagt, "AS IS".  Das bedeutet, dass
  32. Sie  es auf Ihr *eigenes* Risiko benutzen.  Es gibt keinerlei Garantie fuer
  33. irgendetwas.   Ich  kann  lediglich sagen, dass wir es lange genug getestet
  34. haben.
  35.  
  36.   Vielen  Dank  an  dieser  Stelle  an  Michael Herold, der mir sowohl beim
  37. Beta-Testen  des  Programms  als  auch  bei  der  Erstellung der AmigaGuide
  38. Anleitung behilflich war.
  39.  
  40.  
  41.  
  42. Was ist ReqASK?
  43. ~~~~~~~~~~~~~~~
  44.  
  45.   ReqASK  ist  ein leistungsfaehiger Ersatz fuer das Shell Komando ASK.  Es
  46. wird komplett ueber die Maus bedient und hat die Aufgabe, dem Benutzer eine
  47. Auswahl von Optionen zu bieten, aus denen der Benutzer dann eine auswaehlt.
  48. Je  nach  dem  Ergebnis  (der  Wahl des Benutzers) kann dann eine bestimmte
  49. Handlung  ausgeloest  werden.  Anders als aehnliche Programme bietet ReqASK
  50. Ihnen  eine  grosse  Palette  von Features, um sich Ihren Beduerfnissen und
  51. Erfordernissen anzupassen.
  52.  
  53.   Dieses   Programm   benutzt  und  benoetigt  Kickstart  2.04  (v37)  oder
  54. aktueller.  Es braucht ausserdem die "reqtools.library" (von Nico François)
  55. in  der  Version  38 oder aktueller, die als FD z.B.  auf Fish-Diskette 794
  56. erhaeltlich ist.
  57.  
  58.  
  59.  
  60. Benutzung
  61. ~~~~~~~~~
  62.  
  63.   ReqASK  ist  ein Programm fuer das CLI bzw.  die Shell.  Ein Aufruf durch
  64. die Workbench ist daher sinnlos.
  65.  
  66.    BODY/K
  67.  
  68.           Dies  ist  der Haupttext Ihres Requesters.  Wenn Sie diese Option
  69.         aussparen,  werden  alle  weiteren  ignoriert und ein About Fenster
  70.         angezeigt.
  71.  
  72.           Sie  koennen  alle  bekannten Kontroll Sequenzen innerhalb dieses
  73.         Strings benutzen, zum Beispiel *N fuer eine neue Zeile, *" fuer das
  74.         Anfuehrungszeichen.   Schlagen Sie in Ihrem AmigaDOS Handbuch nach,
  75.         wenn Sie weitere Informationen benoetigen.
  76.  
  77.    GADGET/K
  78.  
  79.           Diese  Option definiert die Beschriftung der Gadgets.  Separieren
  80.         Sie  mehrere  Auswahlmoeglichkeiten  durch  das  "|"-Zeichen.  Z.B.
  81.         "Ja|Nein"  oder  vielleicht "Ja|Weiss nicht|Nein".  Sie koennen bis
  82.         zu 100 Auswahlmoeglichkeiten benutzen.
  83.  
  84.           Wenn  Sie  Ihren  Requester  ueber die Tastatur steuern moechten,
  85.         benutzen  Sie  das  Underscore-Zeichen  ("_"),  um  die  Tasten  zu
  86.         kennzeichnen,   die   zur  Beantwortung  gedrueckt  werden  duerfen
  87.         ("_Ja|_Weiss nicht|_Nein").
  88.  
  89.           Beachten Sie bitte, dass Sie mindestens eine der Optionen GADGET,
  90.         IDCMP und TIMEOUT angeben muessen, sonst koennten Sie den Requester
  91.         nicht beantworten.
  92.  
  93.    TITLE/K
  94.  
  95.           Dies ist der Titel Ihres Requesters.  Wenn Sie diese Moeglichkeit
  96.         nicht  nutzen,  wird  entweder  "Information"  eingesetzt (wenn der
  97.         Requester  weniger als 2 Auswahlmoeglichkeiten hat), oder "Request"
  98.         (bei zwei oder mehr Wahlmoeglichkeiten).
  99.  
  100.    VAR=VARIABLE/K
  101.  
  102.           Hier  geben  Sie die Environment Variable an, in der das Ergebnis
  103.         des  Requesters  uebergeben wird.  Lassen Sie dieses Schluesselwort
  104.         weg, wird automatisch der Name "REQASK" vergeben.
  105.  
  106.    GLOBAL/S
  107.  
  108.           Wenn  Sie  dieses  Schluesselwort  angeben,  wird  Ihre  Ergebnis
  109.         Variable global angelegt (erreichbar auch aus anderen Prozessen).
  110.  
  111.    TIME=TIMEOUT/N/K
  112.  
  113.           Ein  nettes  Feature  von ReqASK.  Sie koennen hier ein Zeitlimit
  114.         angeben, nach dem sich der Requester automatisch schliesst (wenn er
  115.         nicht  vorher  vom  Benutzer  beantwortet  wurde).  Die Einheit ist
  116.         Sekunden.
  117.  
  118.           Beachten Sie bitte, dass Sie mindestens eine der Optionen GADGET,
  119.         IDCMP und TIMEOUT angeben muessen, sonst koennten Sie den Requester
  120.         nicht beantworten.
  121.  
  122.    SCREEN=PUBSCREENNAME/K
  123.  
  124.           Name  des  Oeffentlichen  Bildschirms, auf dem sich der Requester
  125.         oeffnen soll.  Wenn Sie diese Option nicht angeben, oeffnet er sich
  126.         auf dem Default Public Screen - im Normalfall auf der Workbench.
  127.  
  128.    FRONT=SCREENTOFRONT/K
  129.  
  130.           Wenn  Sie  diese  Option  auf  "YES"  oder "ON" stellen, wird der
  131.         Screen,  auf  dem  sich  der  Requester oeffnet, automatisch in den
  132.         Vordergrund   springen.    Nachdem   der   Benutzer  den  Requester
  133.         beantwortet hat, geht der Screen wieder dorthin, wo er herkam.
  134.  
  135.           Um diese Option auszuschalten, waehlen Sie "NO" oder "OFF".
  136.  
  137.           Wenn   Sie   dieses   Schluesselwort   weglassen,  wird  auf  das
  138.         ausgewichen, was Sie im Reqtools Voreinsteller ausgewaehlt haben.
  139.  
  140.    CENTER=NOCENTERTEXT/S
  141.  
  142.           ReqASK  zentriert  die  Zeilen  Ihres  Haupttextes  im  Requester
  143.         automatisch.    Wenn   Sie  das  nicht  wollen,  geben  Sie  dieses
  144.         Schluesselwort an.
  145.  
  146.    DEFRES=DEFAULTRESPONSE/N/K
  147.  
  148.           Normalerweise wird  bei mehreren  Gadgets  immer das  ganz  linke
  149.         aktiviert,  wenn  Sie  im  Requester  einfach Return druecken.  Mit
  150.         diesem  Schluesselwort koennen Sie eine andere Default Gadgetnummer
  151.         angeben.
  152.  
  153.           Die Default Antwort wird auf dem Bildschirm fett geschrieben.
  154.  
  155.    FONT/K
  156.  
  157.           Ihr  Requester benutzt ueberlicherweise den Zeichensatz, der auch
  158.         auf dem Bildschirm verwendet wird.  Wenn Sie einen anderen benutzen
  159.         wollen,   geben   Sie   dieses  Schluesselwort  an.   Zum  Beispiel
  160.         FONT="courier.font  13"  wuerde  den Courier Zeichensatz Groesse 13
  161.         benutzen.    Beachten  Sie,  dass  der  Name  und  die  Groesse  in
  162.         Anfuehrungszeichen eingeschlossen sein muessen.
  163.  
  164.    POS=POSITION/K
  165.  
  166.           Wie   auch  das  SCREENTOFRONT  Schluesselwort  fuehrt  auch  ein
  167.         weglassen  dieses  Schluesselwortes  zum  im Reqtools Voreinsteller
  168.         definierten Verhalten.
  169.  
  170.           Diese Option bestimmt die Position auf dem Bildschirm, an der der
  171.         Requester  kommt.   Sie  koennen  eine der folgenden Moeglichkeiten
  172.         waehlen:
  173.  
  174.                 POINTER         Aktuelle Mausposition
  175.  
  176.                 CENTERSCREEN    Mitte des sichtbaren Ausschnitts
  177.                                 des Screens
  178.  
  179.                 TOPLEFTSCREEN   Open links im sichtbaren Ausschnitt
  180.                                 des Screens
  181.  
  182.    LEFT=POS_LEFTOFFSET/N/K
  183.  
  184.           Wenn  Sie  eine  Requester  Position  anders als POINTER gewaehlt
  185.         haben,  koennen  Sie  hier  einen  horizontalen  Versatz  zu dieser
  186.         Position  angeben.   Ansonsten  wird  der  Versatz aus dem Reqtools
  187.         Voreinsteller benutzt.
  188.  
  189.    TOP=POS_TOPOFFSET/N/K
  190.  
  191.           Wenn  Sie  eine  Requester  Position  anders als POINTER gewaehlt
  192.         haben, koennen Sie hier einen vertikalen Versatz zu dieser Position
  193.         angeben.  Ansonsten wird der Versatz aus dem Reqtools Voreinsteller
  194.         benutzt.
  195.  
  196.    RETURN=NORETURNKEY/S
  197.  
  198.           Wenn  Sie nicht wollen, dass Ihr Requester mit Return beantwortet
  199.         werden kann, benutzen Sie dieses Schluesselwort.
  200.  
  201.    LAMG=LAMIGAONLY/S
  202.  
  203.           Fuer  Funktionen,  die vielleicht viel Schaden anrichten koennen,
  204.         ist es sinnvoll, die abgekuerzte Anwahl zu verbieten.  Benutzen Sie
  205.         dazu dieses Schluesselwort.  Sie muessen dann die linke Amiga-Taste
  206.         zusammen  mit  "B" oder "V" druecken, um die positive oder negative
  207.         Antwort zu waehlen.
  208.  
  209.    IDCMP/K
  210.  
  211.           Dies  ist  ein  anderes schoenes Feature von ReqASK.  Sie koennen
  212.         bestimmte  IDCMP  Flaggen  angeben,  die  den Requester automatisch
  213.         beenden.    Sie   koennen  eine  oder  mehrere  aus  den  folgenden
  214.         auswaehlen:
  215.  
  216.                 DISKINSERTED    Eine Disk wurde eingelegt
  217.  
  218.                 DISKREMOVED     Eine Disk wurde herausgenommen
  219.  
  220.                 INACTIVEWINDOW  Das Requesterfenster wurde deaktiviert.
  221.  
  222.           Beachten Sie bitte, dass Sie mindestens eine der Optionen GADGET,
  223.         IDCMP und TIMEOUT angeben muessen, sonst koennten Sie den Requester
  224.         nicht beantworten.
  225.  
  226.    BEEP=DISPLAYBEEP/S
  227.  
  228.           Wenn   Sie  Requester  oft  aus  Hintergrund  Prozessen  starten,
  229.         moechten  Sie  vielleicht  ueber  einen  neuen Requester informiert
  230.         werden.   Wenn Sie diese Option angeben, blinkt Ihr Bildschirm beim
  231.         Oeffnen  des  Requesters  (und je nach Voreinstellungen des Systems
  232.         spielt auch ein Ton).
  233.  
  234.  
  235.  
  236. ReqASK Ergebnis
  237. ~~~~~~~~~~~~~~~
  238.  
  239.   Das  Ergebnis von ReqASK ist aufgeteilt in zwei Teile.  Der erste ist der
  240. CLI  Returncode,  der  ueber  einen  eventuellen  Fehler  informiert.   Ein
  241. Returncode  von  0  sagt,  dass keine Fehler auftraten, ein Wert von 20 das
  242. Gegenteil  (normalerweise  zusammen  mit  einer  naeheren  Beschreibung des
  243. Fehlers in StdOut).
  244.  
  245.   Der zweite und mehr interessante Teil des Ergebnisses ist die Environment
  246. Variable,  die  Informationen  ueber  die  Auswahl des Benutzers beinhaltet
  247. (wenn  keine  Fehler auftraten).  Ein Wert von 0 steht fuer das ganz rechte
  248. Gadget  (FALSE),  die  anderen  sind  von  links  nach  rechts  mit 1 bis N
  249. durchnummeriert.
  250.  
  251.   Es  gibt  noch  zwei spezielle Werte fuer die Variable.  Ein Ergebnis von
  252. 100  bedeutet,  dass  das  Zeitlimit abgelaufen ist, ohne dass der Benutzer
  253. eine  Wahl  getroffen  hat,  ein  Wert von 101 bedeutet, dass der Requester
  254. aufgrund eines IDCMP-Ereignisses geschlossen wurde.
  255.  
  256. BEACHTE:   Im  Fehlerfalle  (CLI  Returncode  = 20) wird die Variable nicht
  257.            veraendert.
  258.  
  259.  
  260.  
  261. Beispiele
  262. ~~~~~~~~~
  263.  
  264.   Tippen Sie diese Beispiele in Ihre Shell und sehen Sie, was passiert:
  265.  
  266. ReqASK
  267.  
  268. ReqASK BODY="Dieser Requester erinnert Sie*Nan den Geburtstag Ihrer Oma" GADGET="_Alles klar" TITLE="Nicht vergessen"
  269.  
  270. ReqASK BODY="Die aktuelle Systemzeit ist*N`Date`" TIME=10
  271.  
  272. ReqASK BODY="Entfernen Sie jetzt die Bootdisk!" IDCMP=DISKREMOVED POS=CENTERSCREEN
  273.  
  274.  
  275.  
  276. History
  277. ~~~~~~~
  278.  
  279. ReqASK 1.0  03-Feb-93  Erste Veroeffentlichung
  280.  
  281.  
  282.  
  283. Zukuenftige Erweiterungen
  284. ~~~~~~~~~~~~~~~~~~~~~~~~~
  285.  
  286.   Das einzige, was ich bisher vorhabe, in ReqASK noch einzubauen, ist ARexx
  287. Unterstuetzung.   Das  ist  nuetzlich,  wenn z.B.  Samples zusammen mit UPD
  288. abgespielt  werden  sollen,  waehrend  der  Requester  auf  dem  Bildschirm
  289. erscheint.
  290.  
  291.   Zum  anderen  denke ich an weitere Ersatz-Befehle fuer ASK.  Zum Beispiel
  292. ein  leistungsfaehiger  FileASK,  der  Sie  ueber einen File-Requester nach
  293. einem  Dateinamen  fragt.   Oder ViewASK, das Sie ueber ein Listview Gadget
  294. zwischen vielen Antworten auswaehlen laesst.
  295.  
  296.   Es  gibt  viele  kleine Dinge zu tun.  Wenn Sie sie demnaechst in die Tat
  297. umgesetzt  sehen  wollen,  dann unterstuetzen Sie mich bitte durch Bezahlen
  298. der Shareware Gebuehr.
  299.  
  300.  
  301.  
  302. Wie erreicht man den Autor?
  303. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  304.  
  305.   Um    Fehlerberichte,    Ideen,    Beschwerden,   und   natuerlich   Ihre
  306. Shareware-Gebuehr von 10.- DM zu bezahlen, erreichen Sie mich unter:
  307.  
  308.         UUCP eMail: marc@aargh.adsp.sub.org
  309.  
  310.         ZNet eMail: marc%aargh.incubus@aworld.zer
  311.  
  312.         Snail Mail: Marc Heuler
  313.                     Stephan Str. 6
  314.                     8700 Wuerzburg
  315.                     GERMANY
  316.  
  317.   Vergessen  Sie nicht, die Sharewaregebuehr zu zahlen, wenn Sie ReqASK oft
  318. benutzen.
  319.  
  320.  
  321.                                                                        Marc
  322.  
  323.